home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / mac / files / f6fbb / rliwpfix.exe / RLIWP.DOC next >
Text File  |  1993-05-06  |  6KB  |  123 lines
  1.                                   RLIWP.EXE
  2.                       FBB --> RLI WP update converter
  3.                       (C) 1993 by Dean R. Madsen, KE0WO
  4.                       KE0WO @ KE0WO.#NWIA.IA.USA.NA
  5.  
  6.         After the release of FBB 5.15 there was a great concern about
  7. incompatibiliy between the W0RLI White Pages and F6FBB White Pages.  This
  8. eventually led to makeshift software hacks, nastygrams and finger pointing.
  9. Now that tempers have cooled and I have been able to play with FBB 5.15 I now
  10. offer my solution to the incompatibility.  Instead of trying to hack into
  11. Jean-Paul's code I found that he has made his software flexible enough to
  12. prevent the need for this and so I have made an external program to change 
  13. only those WP updates destine for W0RLI type systems.
  14.  
  15. -----------------------------Installation------------------------------------
  16. The first thing that needs to be done is to edit the INIT.SRV file to include
  17. WPUPD in the list of those to receive WP update messages from your system.
  18.  
  19. The next thing to do is decide which RLI systems you will be sending updates
  20. to (be sure to be reasonable, you can't send an update message to every system
  21. in the county :-).  Now edit you BBS.SYS file to include an entry for each RLI
  22. system to receive a message.  I suggest that you use an alias for this,such as
  23. suffix of the BBS.  IE: KE0WO becomes WO.
  24.  
  25. After the BBS.SYS is changed the next step is to edit the FORWARD.SYS file.
  26. Here you will have to make an A XXXX entry for every alias you added to your
  27. BBS.SYS.   The format of the entries is:
  28.  
  29. ---------
  30. A THC
  31. G WPUPD
  32. P @
  33. C C:/FBB/THCUPD.IN
  34. ---------
  35. A CJU
  36. G WPUPD
  37. P @
  38. C C:/FBB/CJUUPD.IN
  39. ---------
  40.  
  41. I have previously entered THC and CJU in my BBS.SYS.  The G WPUPD designates
  42. that all bulletins addressed @ WPUPD will be forwarded to the files
  43. C:\FBB\THCUPD.IN and C:\FBB\CJUUPD.IN.  The P @ declares that the forward
  44. is to a file.
  45.  
  46. Now you are able to do the final setup step:  edit the CRON.SYS
  47. In your CRON.SYS you will need to add lines such as the following:
  48.  
  49. IF H 23,0,1,2
  50. X \FBB\BIN\RLIWP.EXE WB0THC C:\FBB\THCUPD.IN
  51. X \FBB\BIN\RLIWP.EXE WA0CJU C:\FBB\CJUUPD.IN
  52. ENDIF
  53.  
  54. The time specification in the IF H line should be several hours after you
  55. have the BBS program set to do its housekeeping.  In my case I have the
  56. BBS set to do its housekeeping at 23:00.  The program to convert the FBB
  57. message to the RLI format will check for a file to process at 23:00, 00:00,
  58. 01:00 and 02:00 during the call to the CRON.SYS file.  It would be useless to
  59. call the converter program every hour when there have been no WP update
  60. messages generated.
  61.  
  62. The next line runs the converter program (RLIWP.EXE) which is located in the
  63. \FBB\BIN directory.  The first parameter is the callsign of the RLI system
  64. that the update message is destine for (in my example WB0THC & WA0CJU, the 
  65. stations that received my WP update messages during the testing of the
  66. converter program.  {it is silly to send WP update messages half way across
  67. the country to find out that it didn't work}).
  68.  
  69. The next parameter is the input file to process.  These should be the same
  70. as was used in the entries in FORWARD.SYS file.
  71.  
  72. ---------------------How it works/what it does-------------------------------
  73.  
  74. After EPURWP is ran and the WP updates are created there will be one as a
  75. bulletin @ WPUPD.  The BBS will then forward this message to files as defined
  76. in the FORWARD.SYS.  At the top of the hour during the indicated times as set
  77. in the CRON.SYS the RLIWP program is run.  If it find the file specified
  78. by the second parameter it will read that file, search for the from callsign
  79. to use (that is located at the end of the message subject: WP update from ...).
  80. and then use this as the callsign the new update is from (which has to be a
  81. valid amateur callsign).  The converter then assigns the proper title for the
  82. message (WP Update) and copies the message text, looking for the /EX that
  83. concludes the message, into the MAIL.IN file.  It then prepares to process 
  84. another message that may be in the same file.  After all messages are 
  85. processed, the input file is deleted.
  86. -----------------------------Conclusion-------------------------------------
  87.  
  88. 1. This software is freeware to the amateur community. It may not be sold.
  89.    It may be freely copied and distributed, but at no charge exceeding the
  90.    medium and shipping.
  91.  
  92. 2. No warranty is expressed or implied and incidental damages resulting from
  93.    the use of this software are solely the responsibility of the user. While
  94.    the software works fine, and I am willing to give it to the amateur 
  95.    community, I am not willing to assume any liabilty for it crashing your
  96.    computer or its peripherals. (It has not done that on any machine we have
  97.    run it on...this is just legal junk to prevent someone from holding me
  98.    responsible for being generous enough to give this server away as a 
  99.    service to the FBB {and RLI?} community.)
  100.  
  101. 3. Feedback on desired features, bugs, etc. are encouraged. 
  102.  
  103. 4. Also check out my modified M_FILTER program which has the capability to
  104.    take ALL incoming RLI WP Updates (weather they are @ your system or not)
  105.    and create a FBB compatable WP update message from the data in order to
  106.    update the FBB WP database.  The M_FILTER program is an excellent
  107.    compliment to this one.
  108.  
  109. Good luck and 73,
  110. Dean - KE0WO
  111.  
  112. US Snail:  Dean R. Madsen, KE0WO
  113.            P. O. BOX 303
  114.            Storm Lake, IA  50588
  115.  
  116. Packet:    KE0WO @ KE0WO.#NWIA.IA.USA.NA
  117.  
  118. Internet:  MADSENDEAN@BVC.EDU
  119.  
  120.  
  121.  
  122.  
  123.